W01-2. 컨테이너 기초 - 실습 가이드

1주차 실습: 컨테이너를 직접 만져 보기

실습 목표 (45분)

강의 노트에서 들은 내용을 내 노트북에서 직접 확인합니다.

  • 컨테이너가 1초 안에 뜨고 메모리를 아주 조금 쓰는 것
  • 컨테이너 안에서는 자기 자신만 보이는 것 (격리된 프로세스)
  • 모든 컨테이너가 커널 하나를 같이 쓰는 것
  • 컨테이너를 지우면 안에서 바꾼 내용이 사라지는 것
시작 전 확인

  • 사전 준비의 5. 최종 점검까지 마쳐야 합니다.
  • Docker Desktop 이 실행 중이어야 합니다(대시보드 왼쪽 아래 Engine running).
  • 터미널: macOS → 터미널 / Windows → PowerShell
  • 아래 명령어는 macOS 와 Windows 가 똑같습니다. 다른 부분만 따로 표시했습니다.

실습 내용 시간
1 첫 컨테이너: hello-world 가 하는 일 5분
2 다른 리눅스를 1초 만에: Ubuntu 와 Alpine 5분
3 컨테이너 안으로 들어가 보기 7분
4 커널은 하나다: uname 으로 확인 5분
5 컨테이너 = 격리된 프로세스 7분
6 웹 서버 3대를 1초 만에 8분
7 컨테이너는 지우면 사라진다 5분
8 정리 3분

실습 1. 첫 컨테이너: hello-world 가 하는 일

docker run --rm hello-world

출력 예시 (주요 부분):

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

출력 해석: 강의 노트 6장의 그림이 그대로 일어났습니다.

단계 의미
1 docker 명령(CLI)이 Docker 엔진(daemon)에게 요청을 보냈습니다
2 엔진이 Docker Hub 에서 hello-world 이미지를 받았습니다(pull). 이미 받아 둔 이미지라면 이 단계는 건너뜁니다
3 엔진이 이미지로 컨테이너를 만들어 실행했습니다
4 컨테이너가 출력한 글자를 내 터미널로 보내 줬습니다
(amd64) 부분은 사람마다 다릅니다

  • Windows / Intel Mac: (amd64)
  • Apple Silicon Mac(M 시리즈): (arm64v8)

내 노트북 CPU 종류에 맞는 이미지를 Docker 가 알아서 골라 받습니다. 이 차이는 4주차에 다시 다룹니다.

명령어 뜯어보기:

docker run --rm hello-world
#  │     │    │      └─ 실행할 이미지 이름
#  │     │    └─ --rm : 컨테이너가 끝나면 자동으로 삭제 (실습 찌꺼기 방지)
#  │     └─ run : 이미지로 컨테이너를 만들고 실행
#  └─ docker CLI

실습 2. 다른 리눅스를 1초 만에: Ubuntu 와 Alpine

내 노트북에 리눅스를 설치하지 않았는데도, 서로 다른 리눅스를 바로 실행할 수 있습니다.

docker run --rm ubuntu:26.04 cat /etc/os-release

출력 예시 (앞부분):

PRETTY_NAME="Ubuntu 26.04.1 LTS"
NAME="Ubuntu"
VERSION_ID="26.04"
VERSION="26.04.1 LTS (Resolute Raccoon)"
docker run --rm alpine:3.24 cat /etc/os-release

출력 예시 (앞부분):

NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.24.2
무슨 일이 일어났나요?

cat /etc/os-release 는 "이 리눅스가 무엇인지" 알려 주는 파일을 출력하는 명령입니다.
이미지 이름 뒤에 실행할 명령을 붙이면, 컨테이너는 그 명령 하나만 실행하고 바로 끝납니다.

이미지 크기도 비교해 봅니다.

docker image ls ubuntu:26.04
docker image ls alpine:3.24

출력 예시:

IMAGE          ID             DISK USAGE   CONTENT SIZE   EXTRA
ubuntu:26.04   da6fc2be5478        160MB         45.3MB
IMAGE         ID             DISK USAGE   CONTENT SIZE   EXTRA
alpine:3.24   294b683cb724         13MB         3.94MB
열 의미
DISK USAGE 압축을 풀어 내 디스크에 차지하는 크기
CONTENT SIZE 내려받은(압축된) 크기
생각해 보기

Ubuntu 서버용 VM 이미지는 보통 수 GB 입니다. 그런데 Ubuntu 컨테이너 이미지는 160MB, Alpine 은 13MB 입니다.
이렇게 작을 수 있는 이유는? → 커널이 없기 때문입니다. 커널은 호스트 것을 같이 씁니다(실습 4에서 확인).


실습 3. 컨테이너 안으로 들어가 보기

-it 옵션을 주면 컨테이너 안의 셸(명령 창)을 내 터미널에서 직접 쓸 수 있습니다.

docker run -it --rm ubuntu:26.04 bash

프롬프트가 아래처럼 바뀌면 컨테이너 안입니다. @ 뒤의 글자는 사람마다 다릅니다.

root@f9de64d417b6:/#

컨테이너 안에서 아래 명령을 하나씩 입력합니다.

hostname        # 컨테이너의 호스트 이름 (= 컨테이너 ID 앞 12자리)
ls /            # 리눅스 기본 폴더 구조가 다 있음
ps              # 실행 중인 프로세스 목록

출력 예시:

root@f9de64d417b6:/# hostname
f9de64d417b6
root@f9de64d417b6:/# ls /
bin  boot  dev  etc  home  lib  lib64  media  mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var
root@f9de64d417b6:/# ps
    PID TTY          TIME CMD
      1 ?        00:00:00 bash
      8 ?        00:00:00 ps
ps 결과를 잘 보세요

내 노트북에서는 수백 개의 프로그램이 돌고 있습니다. 그런데 컨테이너 안에서는 bash 와 방금 친 ps 둘만 보입니다.
게다가 bash 가 PID 1번입니다. 강의 노트의 Namespace(칸막이) 가 바로 이것입니다.

다 봤으면 컨테이너에서 나옵니다.

exit

--rm 을 줬기 때문에 exit 하면 컨테이너는 자동으로 지워집니다.

옵션 의미
-i (interactive) 키보드 입력을 컨테이너로 전달
-t (tty) 터미널 화면처럼 보이게 함 (프롬프트, 줄바꿈)
-it 위 둘을 같이 쓴 것. "컨테이너 안에 들어가서 작업" 할 때 항상 씁니다

실습 4. 커널은 하나다: uname 으로 확인

uname -r 은 커널 버전을 알려 주는 명령입니다. 서로 다른 두 리눅스에서 실행해 봅니다.

docker run --rm ubuntu:26.04 uname -r
docker run --rm alpine:3.24 uname -r

출력 예시 (Windows):

6.6.87.2-microsoft-standard-WSL2
6.6.87.2-microsoft-standard-WSL2

출력 예시 (macOS): 숫자는 다를 수 있고, 끝에 linuxkit 이 붙습니다.

x.x.xx-linuxkit
x.x.xx-linuxkit
확인할 점 두 가지

  1. Ubuntu 와 Alpine 은 서로 다른 리눅스인데 커널 버전이 똑같습니다. → 두 컨테이너가 같은 커널 하나를 공유한다는 증거입니다.
  2. 내 노트북은 Windows / macOS 인데 리눅스 커널이 나옵니다. → Docker Desktop 이 띄운 작은 리눅스 VM 의 커널입니다.
    • Windows: microsoft-standard-WSL2 (WSL 2 의 리눅스 커널)
    • macOS: linuxkit (Docker Desktop 이 쓰는 리눅스)

옆 사람과 비교해 봅시다. CPU 종류도 확인합니다.

docker run --rm alpine:3.24 uname -m
노트북 출력
Windows / Intel Mac x86_64
Apple Silicon Mac aarch64
왜 이게 중요할까요? (4주차 예고)

Apple Silicon Mac 에서 만든 이미지는 기본적으로 arm64 용입니다. 그대로 x86_64 서버에 올리면 실행이 안 될 수 있습니다.
우리 스터디는 Mac 과 Windows 가 섞여 있으니, 4주차에 두 CPU 에서 모두 도는 이미지를 만드는 법을 배웁니다.


실습 5. 컨테이너 = 격리된 프로세스

이번에는 컨테이너를 백그라운드로 띄워 두고, 바깥과 안에서 각각 들여다봅니다.

docker run -d --name study-sleeper alpine:3.24 sleep 3600
옵션 의미
-d (detach) 백그라운드로 실행하고 터미널을 바로 돌려줌
--name study-sleeper 컨테이너에 이름을 붙임 (없으면 Docker 가 아무 이름이나 붙임)
sleep 3600 3600초(1시간) 동안 그냥 기다리는 명령

출력 예시: 긴 글자는 컨테이너 ID 입니다.

5a050c26a993d3c2...

5-1. 지금 떠 있는 컨테이너 목록

docker ps

출력 예시:

CONTAINER ID   IMAGE         COMMAND        CREATED         STATUS         PORTS     NAMES
5a050c26a993   alpine:3.24   "sleep 3600"   5 seconds ago   Up 4 seconds             study-sleeper

5-2. 바깥(Docker 엔진)에서 본 모습

docker top study-sleeper

출력 예시:

UID      PID      PPID     C    STIME    TTY    TIME       CMD
root     4493     4470     0    04:17    ?      00:00:00   sleep 3600

5-3. 컨테이너 안에서 본 모습

docker exec 는 이미 실행 중인 컨테이너 안에서 명령을 하나 더 실행합니다.

docker exec study-sleeper ps

출력 예시:

PID   USER     TIME  COMMAND
    1 root      0:00 sleep 3600
    7 root      0:00 ps
같은 프로세스, 다른 번호

보는 위치 sleep 3600 의 PID
바깥 (docker top) 4493 (사람마다 다름)
안 (docker exec ... ps) 1

같은 프로세스인데 보는 위치에 따라 번호가 다릅니다.
컨테이너는 VM 처럼 따로 부팅한 컴퓨터가 아니라, 리눅스 위의 평범한 프로세스에 칸막이를 친 것이기 때문입니다.


실습 6. 웹 서버 3대를 1초 만에

nginx 웹 서버 컨테이너 3개를 동시에 띄워 봅니다.

docker run -d --name study-web-1 -p 8081:80 nginx:1.30-alpine
docker run -d --name study-web-2 -p 8082:80 nginx:1.30-alpine
docker run -d --name study-web-3 -p 8083:80 nginx:1.30-alpine
-p 8081:80 이 뭔가요? (3주차에 자세히)

내 노트북의 8081번 포트로 들어온 요청을 컨테이너의 80번 포트로 전달하라는 뜻입니다.
컨테이너 3개가 모두 안에서는 80번을 쓰지만, 바깥 포트를 8081 / 8082 / 8083 으로 다르게 줘서 충돌하지 않습니다.

6-1. 브라우저로 접속

브라우저에서 아래 주소를 하나씩 엽니다.

세 곳 모두 Welcome to nginx! 페이지가 보이면 성공입니다.

6-2. 자원 사용량 확인

docker stats --no-stream study-web-1 study-web-2 study-web-3

출력 예시:

CONTAINER ID   NAME          CPU %     MEM USAGE / LIMIT     MEM %     NET I/O     BLOCK I/O   PIDS
2e5af9b92753   study-web-1   0.00%     10.29MiB / 7.304GiB   0.14%     ...         ...         ...
...            study-web-2   0.00%     10.3MiB / 7.304GiB    0.14%     ...         ...         ...
...            study-web-3   0.00%     10.26MiB / 7.304GiB   0.14%     ...         ...         ...
VM 이었다면?

웹 서버 3대를 VM 으로 띄우면, VM 마다 OS 를 부팅해야 하고 OS 몫의 메모리도 각각 필요합니다.
컨테이너는 웹 서버 하나에 약 10MB 입니다. LIMIT 은 Docker Desktop 의 리눅스 VM 에 할당된 메모리라서 사람마다 다릅니다.

6-3. 시작 시간 재 보기

컨테이너 하나를 만들고, 명령을 실행하고, 지우기까지 걸리는 시간을 잽니다.

macOS:

time docker run --rm alpine:3.24 echo "hello container"

출력 예시: 맨 끝의 total 이 전체 걸린 시간(초)입니다. 숫자는 사람마다 다릅니다.

hello container
docker run --rm alpine:3.24 echo "hello container"  0.03s user 0.02s system 4% cpu 0.879 total

Windows (PowerShell):

Measure-Command { docker run --rm alpine:3.24 echo "hello container" } | Select-Object TotalSeconds

출력 예시:

TotalSeconds
------------
   0.6698654

실습 노트북 기준 1초가 안 걸립니다. VM 부팅과 비교해 보세요.


실습 7. 컨테이너는 지우면 사라진다

Ubuntu 이미지에는 curl(웹 요청 도구)이 없습니다. 컨테이너 안에 설치해 보겠습니다.

7-1. 컨테이너 안에 curl 설치

docker run -it --name study-ubuntu ubuntu:26.04 bash

이번에는 --rm 을 빼고 이름을 붙였습니다. 나와도 컨테이너가 남아 있게 하려는 것입니다.

컨테이너 안에서:

apt-get update
apt-get install -y curl
curl -sI https://www.docker.com | head -1
exit

출력 예시 (마지막 curl 결과):

HTTP/2 200

7-2. 새 컨테이너에서 curl 을 찾아보기

docker run --rm ubuntu:26.04 bash -c "command -v curl || echo 'curl 없음'"

출력 예시:

curl 없음
왜 없을까요?

새 컨테이너는 언제나 이미지 상태 그대로 시작합니다. 앞에서 설치한 curl 은 study-ubuntu 컨테이너 안에만 있습니다.

7-3. 앞 컨테이너에서 무엇이 바뀌었는지 보기

docker diff study-ubuntu

출력 예시 (앞부분):

C /etc
A /etc/gss
A /etc/gss/mech.d
...
기호 의미
A Added: 새로 생긴 파일 / 폴더
C Changed: 바뀐 파일 / 폴더
D Deleted: 지워진 파일 / 폴더

이제 이 컨테이너를 지웁니다.

docker rm study-ubuntu
기억할 것

컨테이너를 지우면 docker diff 에 나온 변경 내용도 함께 사라집니다.
그래서 실무에서는 아래처럼 합니다.

  • 필요한 프로그램은 이미지에 미리 넣는다 → 4주차 Dockerfile
  • 남겨야 하는 데이터는 컨테이너 밖에 둔다 → 3주차 볼륨

실습 8. 정리

오늘 만든 컨테이너를 모두 지웁니다. 이름이 study- 로 시작하는 것만 지우므로 다른 작업물은 안전합니다.

docker rm -f study-sleeper study-web-1 study-web-2 study-web-3
옵션 의미
docker rm 컨테이너 삭제 (멈춘 것만 지울 수 있음)
-f (force) 실행 중인 것도 멈추고 바로 삭제

남은 컨테이너가 있는지 확인합니다.

docker ps -a

-a 는 멈춘 컨테이너까지 모두 보여 줍니다. study- 로 시작하는 것이 하나도 없으면 정리 끝입니다. ✅
이미지(ubuntu:26.04 등)는 다음 주에도 쓰니 지우지 않습니다.


자주 나는 문제와 해결

증상 원인 해결
Bind for 0.0.0.0:8081 failed: port is already allocated 그 포트를 다른 컨테이너나 프로그램이 이미 쓰는 중 다른 포트(예: -p 8091:80)로 바꿉니다. 실패해도 컨테이너가 "Created" 상태로 남으니 docker rm <이름> 으로 지운 뒤 다시 실행합니다
Conflict. The container name "/study-web-1" is already in use 같은 이름의 컨테이너가 이미 있음 (멈춘 것 포함) docker rm -f study-web-1 후 다시 실행
-it 로 들어갔는데 빠져나오는 법을 모르겠음 - exit 입력 (또는 Ctrl + D)
Windows 에서 cat: can't open 'C:/Program Files/Git/...' Git Bash 를 쓰고 있음 PowerShell 로 다시 실행 (사전 준비 4-1 참고)
toomanyrequests Docker Hub 받기 제한 docker login 확인

오늘 쓴 명령어 정리

명령어 하는 일
docker run <이미지> [명령] 이미지로 컨테이너를 만들고 실행
docker run --rm ... 끝나면 컨테이너 자동 삭제
docker run -it ... bash 컨테이너 안에 들어가서 작업
docker run -d --name <이름> ... 이름을 붙여 백그라운드로 실행
docker run -p 8081:80 ... 내 PC 8081 → 컨테이너 80 연결
docker ps / docker ps -a 실행 중인 / 모든 컨테이너 목록
docker exec <이름> <명령> 실행 중인 컨테이너 안에서 명령 실행
docker top <이름> 컨테이너의 프로세스를 바깥에서 보기
docker stats --no-stream 컨테이너 자원 사용량
docker diff <이름> 이미지 대비 바뀐 파일
docker image ls 내려받은 이미지 목록
docker rm [-f] <이름> 컨테이너 삭제

복습 과제

확인 퀴즈

  1. VM 과 컨테이너의 가장 큰 구조적 차이는 무엇인가요?
  2. 실습 4에서 Ubuntu 와 Alpine 의 uname -r 결과가 같았던 이유는?
  3. 실습 5에서 같은 sleep 프로세스의 PID 가 바깥에서는 4493, 안에서는 1이었습니다. 어떤 커널 기능 때문인가요?
  4. 컨테이너 안에서 설치한 curl 이 새 컨테이너에는 없었던 이유는?
  5. macOS / Windows 노트북에서 리눅스 컨테이너가 돌아가는 원리는?

도전 과제 (선택)

  1. docker run -d --name study-web -p 8080:80 nginx:1.30-alpine 으로 띄운 뒤, docker exec -it study-web sh 로 들어가서 아래처럼 첫 페이지를 바꿔 보세요. 그리고 http://localhost:8080 을 새로고침해 보세요.

    echo '<h1>Hello from my container!</h1>' > /usr/share/nginx/html/index.html
    exit
    
  2. 그 컨테이너를 지우고(docker rm -f study-web) 같은 명령으로 다시 띄우면 첫 페이지는 어떻게 될까요? 이유도 설명해 보세요.

  3. Docker Desktop 대시보드의 Containers 화면에서 실행 중인 컨테이너의 Logs, Exec, Stats 탭을 눌러 보세요. 오늘 터미널로 한 일을 화면으로도 할 수 있습니다.

다음 주 예고: 2주차 Docker 기본

오늘은 docker run 하나로 많은 것을 했습니다. 다음 주에는 컨테이너의 생명주기(생성 → 실행 → 정지 → 삭제)와 로그 보기, 이미지 관리를 체계적으로 익힙니다.


네비게이션

이전 목록 다음
◀ 1주차 강의 노트 목록으로 2주차 강의 노트 ▶